home *** CD-ROM | disk | FTP | other *** search
/ 8bitfiles.net/archives / archives.tar / archives / compuserve-file-archive / 01 New Uploads / UNZP6420.PRG / UNZIP64V2-DOCS next >
Encoding:
Text File  |  1998-04-06  |  8.3 KB  |  310 lines

  1.  
  2.              ╒NZIP64V2.00
  3.              ------------
  4.  
  5.       ├OPYRIGHT 1998 ┼RROL ╙MITH
  6.  
  7.  ╘HIS IS THE FIRST PUBLIC RELEASE
  8. VERSION OF ╒NZIP64V2, A PROGRAM TO
  9. DECOMPRESS 'ZIP' ARCHIVES CREATED BY
  10. ╨╦┌╔╨V2.04G OR EQUIVALENT PROGRAMS. ╔T
  11. WILL WORK ON A C64 OR C128 IN 64 MODE.
  12.  
  13.  ╘HIS PROGRAM IS FREE TO BE DISTRIBUTED
  14. AS LONG AS IT IS UNMODIFIED IN IT'S
  15. ORIGINAL ARCHIVE, USING THE ORIGINAL
  16. FILENAME. (╒╬┌╨6420.╨╥╟)
  17. ╬╧╘┼ ╘HE FILE IS A SELF-EXTRACTING-ZIP,
  18. -NOT- A 'NORMAL' C64 PROGRAM. ╨LEASE DO
  19. NOT COMPRESS IT WITH SOMETHING ELSE!
  20. (YOU WON'T GAIN MUCH IF YOU TRY)
  21.  
  22.  ╔F YOU FIND THE PROGRAM USEFUL, ╔
  23. WOULD APPRECIATE SOME ENCOURAGEMENT TO
  24. CONTINUE DEVELOPMENT. ┴ DONATION OF $10
  25. (OR MORE! (-: ) IS SUGGESTED, THOUGH A
  26. SIMPLE APRECIATIVE EMAIL/LETTER WILL
  27. SUFFICE.
  28.  ╔ WOULD ALSO BE HAPPY WITH DONATIONS
  29. OF SOFTWARE (EG. IF YOU ARE A SOFTWARE
  30. AUTHOR OR DISTRIBUTOR), OR HARDWARE (A
  31. 128 WOULD BE NICE, AS WOULD UTILITY
  32. CARTS - ┴╥, ╞├ ETC, OR ANY ├═─ DEVICE).
  33. ╔F YOU WOULD LIKE TO DONATE SOME OF THE
  34. ABOVE PLEASE CONTACT ME IN ADVANCE.
  35.  ┴NYONE MAKING A HEALTHY CONTRIBUTION
  36. WILL RECIEVE ACKNOWLEDGEMENT IN THIS
  37. DOCUMENTATION AS WELL AS ON MY WEB
  38. PAGE.
  39.  
  40.  ╔ WOULD LIKE TO THANK ALL THE PEOPLE
  41. THAT HELPED BETA TEST THE PROGRAM AND
  42. PROVIDE FEEDBACK & SUGGESTIONS -
  43. PARTICULARLY THOSE THAT SUPPLIED ME
  44. WITH ZIP FILES CAUSING THE PROGRAM TO
  45. BREAK. ╫ITHOUT THOSE ZIP FILES TRACKING
  46. DOWN THE BUGS WOULD HAVE BEEN NEXT TO
  47. IMPOSSIBLE.
  48.  ╘HOUGH THIS IS A PUBLIC RELEASE, THE
  49. PROGRAM IS FAR FROM FINISHED, THOUGH ╔
  50. AM CONFIDENT THAT MOST BUGS HAVE BEEN
  51. IRONED OUT. (STILL GOT WRINKLES THOUGH)
  52.  
  53.  
  54. ├ONTACT ╔NFORMATION
  55. -------------------
  56.  
  57.  ╘HE LATEST NEWS & UPDATES OF UNZIP64V2
  58. CAN BE FOUND ON MY 64 WEB PAGE AT:
  59. HTTP://WWW.ROS.COM.AU/^ERROL/64.HTML
  60. (NOTE THE ^ ABOVE REPRESENTS A TILDE OR
  61. 'SQUIGLY LINE')
  62.  
  63. ╔NTERNET E-MAIL: ERROL@ROS.COM.AU
  64.  
  65. ╞IDONET ╬ETMAIL: ┼RROL ╙MITH
  66.                  3:712/523.5
  67.  
  68. á╔ CAN ALSO BE CONTACTED IN ANY OF THE
  69. ╞IDONET ├┬═, ├┬═-128 & ├┬═-╟┼╧╙ ECHOES.
  70.  
  71. ╙NAIL ═AIL:
  72.  ┼RROL ╙MITH
  73.  ╨╧ ┬OX 119
  74.  ╥OUND ├ORNER
  75.  ╬╙╫ 2158
  76.  ┴USTRALIA
  77.  
  78.  
  79. ╔MPORTANT ╬OTES
  80. ---------------
  81.  
  82. * ╘HIS PROGRAM IS STILL IN DEVELOPMENT,
  83. AND MAY STILL CONTAIN BUGS. ╔T DOES NOT
  84. HAVE MUCH IN THE WAY OF ERROR CHECKING,
  85. AND MAY CRASH OR ACT UNPREDICTABLY. ┴NY
  86. BUG REPORTS & SUGGESTIONS FOR
  87. IMPROVEMENTS ARE WELCOME. ╔F REPORTING
  88. A BUG ╔ WOULD APRECIATE BEING SENT THE
  89. ZIPFILE THAT CAUSED THE ERROR (IF THE
  90. ZIP FILE IS VALID).
  91.  
  92. * ╒NZIP64V2 CANNOT DECOMPRESS ┌╔╨'S
  93. CREATED BY ╨╦┌╔╨1.XX. ┘OU WILL NEED TO
  94. USE ┬ILL ╠UCIER'S ╒NZIP64 OR ─AVID
  95. ╙CHMOLLS ╬┌╨128 PACKAGE TO DECOMPRESS
  96. THESE FILES. (THE EXCEPTION TO THIS IS
  97. IF THE FILES ARE ALL STORED, BUT THAT
  98. IS UNLIKELY).
  99.  ╔F ╒NZIP64V2 SAYS '╒╬╙╒╨╨╧╥╘┼─!' WHEN
  100. UNZIPPING THEN YOU PROBABLY HAVE A
  101. ┌╔╨1.XX ARCHIVE.
  102.  
  103. * ╔ HAVE CHANGED THE VERSION CONVENTION
  104. SINCE THE BETA TESTING TO UNZIP64V2.XX
  105. WHERE 2.XX IS THE REVISION NUMBER,
  106. STARTING WITH 2.00 WITH THIS INITIAL
  107. RELEASE. ─ON'T GET CONFUSED.
  108.  
  109. * ╔F YOU POSESS OR KNOW OF ANY BETA
  110. VERSIONS OF UNZIP64V2, PLEASE DELETE
  111. THEM. ╘HIS IS ESPECIALLY TRUE OF ANY
  112. PUBLICLY AVAILABLE VERSIONS (EG ON ┬┬╙
  113. OR ╞╘╨ SITES). -┴╠╠- THE BETA VERSIONS
  114. HAVE BUGS AND SHOULD BE ELIMINATED.
  115.  
  116. * ╘HE DISTRIBUTION ARCHIVE -╔╙- A SELF
  117. EXTRACTING ZIP ARCHIVE. ╒NFORTUNATELY
  118. THE CODE IS CUSTOM WRITTEN FOR THIS
  119. PACKAGE AND ISN'T PUBLICLY USEABLE.
  120. ╘HERE ARE SEVERE PRACTICAL LIMITATIONS
  121. TO USING ZIP FOR SELF EXTRACTING FILES,
  122. SO DON'T EXPECT A PUBLICLY USABLE
  123. '╙╪┌' (??) MODULE IN THE NEAR FUTURE.
  124.  ╔ DIDN'T CALL THE DISTRIBUTION AN ╙╞╪
  125. AS IT WOULD BE CONFUSED WITH ╠┌╚á╙╞╪
  126. FILES. ╔ PROPOSE THE EXTENSION '╙╪┌'
  127. FOR FUTURE ╙ELF E╪TRACTING ┌IPS. ┴NY
  128. COMMENTS?
  129.  
  130.  
  131. ═AIN ═ENU
  132. ---------
  133.  
  134.  ═OST OPTIONS ARE REASONABLY SELF
  135. EXPLANATORY BUT ╔'LL DETAIL THEM ANYWAY
  136. TO HELP STOP ANY CONFUSION.
  137.  
  138. ╞1 - ╙HOWS A DIRECTORY OF THE INPUT
  139.      DEVICE, USING THE SOURCE PATH.
  140.  
  141. ╞2 - ╘HIS TOGGLES THE INPUT DEVICE
  142.      NUMBER. ╘HIS IS THE DEVICE THAT
  143.      THE SOURCE ZIP FILE IS ON. ╔T
  144.      SHOULD AUTOMATICALLY FIND THE NEXT
  145.      VALID DEVICE ON YOUR SYSTEM. ╓ALID
  146.      DEVICE NUMBERS ARE 8 THROUGH 30.
  147.  
  148. +  - ├HANGE THE SOURCE PATH. ╘HIS IS
  149.      ONLY OF USE TO USERS OF ├═─ TYPE
  150.      DEVICES, AND ALLOWS YOU TO SET THE
  151.      PARTITION & SUBDIRECTORY FOR THE
  152.      SOURCE ZIP FILES. ╘HE PATH YOU
  153.      ENTER IS PRE-PENDED TO THE INPUT
  154.      FILE VERBATIM. ╔T ═╒╙╘ INCLUDE A
  155.      TRAILING COLON!
  156.  
  157. ╞3 - ╙HOWS A DIRECTORY OF THE
  158.      DESTINATION DEVICE, USING THE
  159.      DESTINATION PATH.
  160.  
  161. ╞4 - ╘OGGLES THE DESTINATION DEVICE
  162.      NUMBER (WHERE THE EXTRACTED FILES
  163.      WILL GO). ╙IMILAR TO ╞2.
  164.  
  165. -  - ├HANGE THE DESTINATION PATH. ╘HIS
  166.      IS WHERE EXTRACTED FILES WILL GO.
  167.      ╙EE NOTES ABOVE ABOUT SOURCE PATHS
  168.      & REMEMBER THE TRAILING COLON.
  169.  
  170. ╞5 - ╙ET ZIP FILENAME. ┴LLOWS YOU TO
  171.      CHANGE THE NAME OF THE INPUT FILE.
  172.  
  173. ╞6 - ╘OGGLE THE DEFAULT OUTPUT FILE
  174.      TYPE - ╨ (╨╥╟) OR ╙ (╙┼╤). ╘HIS IS
  175.      THE FILE TYPE THAT EXTRACTED FILES
  176.      WILL HAVE. ╬OTE YOU CAN MANUALLY
  177.      OVERRIDE THIS WITH INDIVIDUAL
  178.      FILES.
  179.  
  180. ╞7 - ╒NZIP A FILE. ╘HIS STARTS
  181.      UNZIPPING THE SPECIFIED FILE. ╙EE
  182.      '╒NZIPPING' LATER ON FOR DETAILS.
  183.  
  184. Q  - ╤UIT UNZIP64V2.
  185.  
  186.  ╟ENERALLY TO USE UNZIP64V2, YOU SET
  187. THE APPROPRIATE SOURCE & DESTINATION
  188. DEVICES (AND PATHS IF NEEDED), SET THE
  189. ZIP FILE NAME WITH ╞5, THEN START
  190. UNZIPPING WITH ╞7.
  191.  
  192.  
  193. ╒N┌IPPING
  194. ---------
  195.  
  196.  ╒NZIPPING HANDLES FILES WITHIN THE ZIP
  197. ARCHIVE ONE AT A TIME. ┴S EACH FILE IS
  198. PROCESSED, THE FILENAME WILL BE
  199. DISPLAYED, FOLLOWED BY A QUERY WITH
  200. OPTIONS [YNQAPS]. ┼ACH LETTER MEANS THE
  201. FOLLOWING:
  202.  
  203. Y - ┼XTRACT THIS FILE USING THE DEFAULT
  204.     FILE TYPE.
  205. N - ─O NOT EXTRACT THIS FILE & SKIP
  206.     TO THE NEXT ONE.
  207. Q - ╤UIT UNZIPPING & RETURN TO THE MENU
  208. A - ┼XTRACT THIS FILE AND ┴╠╠ REMAINING
  209.     FILES WITHOUT FURTHER PROMPTS,
  210.     USING THE DEFAULT FILE TYPE.
  211. P - ┼XTRACT THIS FILE AS A ╨╥╟ FILE,
  212.     REGARDLESS OF THE DEFAULT TYPE.
  213. S - ┼XTRACT THIS FILE AS A ╙┼╤ FILE,
  214.     REGARDLESS OF THE DEFAULT TYPE.
  215.  
  216.  ╙IMPLY PRESS THE LETTER OF THE OPTION
  217. YOU WANT.
  218.  ╘HE SCREEN BORDER WILL FLASH DURING
  219. INFLATING - THIS IS DEBUGGING INFO FOR
  220. MYSELF, PLUS IT LETS YOU KNOW THAT
  221. SOMETHING IS HAPPENING WHEN INFLATING
  222. FILES.
  223.  ╨LEASE ENSURE THERE IS ADEQUATE DISK
  224. SPACE ON THE DESTINATION DRIVE BEFORE
  225. BEGINNING!
  226.  
  227.  
  228. ╨AST, ╨RESENT & ╞UTURE
  229. ----------------------
  230.  
  231.  ╘HIS PROGRAM HAS BEEN IN DEVELOPMENT
  232. PART-TIME FOR OVER 2 YEARS (SINCE LATE
  233. 1995). ╔ BEGAN THE PROJECT PRIMARILY AS
  234. A SELF-EDUCATION ON COMPRESSION THEORY.
  235. ╔T WAS ALSO A SHIFT FROM MY PREVIOUS ├=
  236. EXPERIENCE WHICH WAS ALMOST ENTIRELY
  237. DEMO-CODING.
  238.  
  239.  ╘HE PROGRAM CODE IS BASED PARTLY ON
  240. PUBLICLY AVAILABLE ├ SOURCE
  241. (EG. ╔NFO-╒NZIP) ALONG WITH MANY OTHER
  242. SOURCES OF INFORMATION ON COMPRESSION
  243. THEORY, AND THE DEFLATE ALGORITHM.
  244.  ╒NZIP64V2 USES APPROXIMATELY 35K OF
  245. MEMORY DURING DECOMPRESSION. 32K IS
  246. USED FOR THE SLIDING DICTIONARY, AND
  247. THE REMAINDER IS USED FOR THE VARIOUS
  248. HUFFMAN TABLES. ╘HE DEFLATE CODE ITSELF
  249. IS APPROXIMATELY 2.5K, PLUS VARIOUS
  250. LOOKUP TABLES & VARIABLE SPACE. ╘HE
  251. REMAINDER OF THE PROGRAM IS CODE TO
  252. HANDLE THE ZIP ARCHIVE FORMAT, STORED
  253. FILES, THE USER INTERFACE & MISC. DISK
  254. ROUTINES.
  255.  
  256.  ╔ HAVE MANY IDEAS FOR THE FUTURE, BOTH
  257. MY OWN AND THAT OF THE MANY PEOPLE WHO
  258. HAVE PROVIDED INPUT TO THIS PROGRAM
  259. DURING BETA TESTING. ╘HOUGH ╔ CAN'T
  260. PROMISE TO DO ANY OF THEM, HERE ARE
  261. SOME OF THE IDEAS FOR FUTURE VERSIONS:
  262. (IN NO PARTICULAR ORDER)
  263.  - ├╥├ CHECKING
  264.  - ╙PEED IMPROVEMENTS
  265.  - ┬ETTER HANDLING OF CORRUPTED ZIPS
  266.  - ╒SER ╔NTERFACE IMPROVEMENTS
  267.  - ╒SE OF 2MHZ MODE ON A 128 IN 64 MODE
  268.  - ╬ATIVE 128 VERSION
  269.  - ┴BILITY TO LIST THE FILES IN A ZIP
  270.    WITHOUT EXTRACTING THEM
  271.  - ╨ICK LIST FOR CHOOSING SOURCE ZIPS
  272.  - ─OS WEDGE
  273.  - ├REATION OF STORED ZIP FILES.
  274.  - ├REATION OF COMPRESSED ZIP FILES (!)
  275.  - ╙ELF E╪TRACTING ┌IP ROUTINE (╙╪┌??)
  276.  - ┼XTRACTION OF ╟┌╔╨ ARCHIVES
  277.  - ─ECOMPRESSION OF ZIP1.XX ARCHIVES
  278.    (IMPLODED, SHRUNK, REDUCED)
  279.  
  280.  ╫HICH OF THESE IS DONE AND WHEN WILL
  281. BE DETERMINED LARGELY BY USER FEEDBACK
  282. AS TO WHAT PEOPLE WANT, HOW MUCH
  283. INSPIRATION ╔áHAVE, AND WHAT IS
  284. ACTUALLY PRACTICAL. (╧H, AND HOW MUCH
  285. ENCOURAGEMENT ╔ GET! (-: )
  286.  ├OMPRESSION IS A LARGE STEP, AND MAY
  287. BE QUITE DIFFICULT (IF NOT IMPOSSIBLE)
  288. ON A STOCK 64 (OR EVEN GENERALLY).
  289. ├REATION OF STORED-ONLY ZIP ARCHIVES IS
  290. RELATIVELY EASIER, BUT THE USEFULNESS
  291. OF UNCOMPRESSED ARCHIVES IS PERHAPS
  292. QUESTIONABLE.
  293.  ┴ 128 VERSION IS DIFFICULT AT PRESENT
  294. AS ╔ DON'T OWN A 128 NOR DO ╔ HAVE
  295. ACCESS TO THE PROGRAMMING INFORMATION
  296. REQUIRED FOR A CONVERSION. ╙O IF
  297. ANYBODY WANTS TO DONATE A C128 AND/OR
  298. 128 PROGRAMMERS REFERENCE GUIDE.......
  299.  
  300.  ┴NYWAY, COMMENTS, CONSTRUCTIVE
  301. CRITICISM OR CASH PAYMENTS ARE ALL
  302. WELCOME! <GRIN>
  303.  
  304. ┼RROL ╙MITH
  305.  
  306. (A.K.A ╙TROBE/???)
  307.  
  308. ┼ND.
  309.  
  310.